home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / PROGRAMM / DB_CLIPP / 0264.ZIP / OUTER.ARC / OUTER.DOC next >
Text File  |  1986-08-05  |  5KB  |  124 lines
  1.  
  2.                                      OUTER
  3.  
  4.                                 Copyright 1986
  5.                                        by
  6.                                   Jim Fullton
  7.  
  8. OUTER is a program written in the C programming language to support the
  9. O)utside command in Fido.  OUTER allows a remote user to run external programs
  10. that the sysop selects.  The sysop has complete control over what programs
  11. are usable by users at each privilege level, and a log of all activity is
  12. maintained.
  13.  
  14. CALLING SYNTAX:
  15.  
  16.      OUTER { /1 | /2 | /t } [ time/l ] [ pin/v ]
  17.  
  18. The parameters have exactly the same meaning as those used with Fido.
  19.  
  20. FILES USED BY OUTER
  21.  
  22. OUTER.WEL - a text file containing a welcome message to be displayed when
  23. the user first enters OUTER.
  24.  
  25. OUTER.HLP - a text file containing information to be displayed when the user
  26. enters the "?" command.
  27.  
  28. OUTER.LOG - maintained by OUTER.  This file will contain the user's name, the
  29. time he/she started OUTER; the command and starting time of each service
  30. executed; the time of return from each service, and the time OUTER was exited.
  31.  
  32. OUTER.CMD - a text file containing the list of commands OUTER can execute.
  33. Each line has the form:
  34.  
  35.    P;C;Command_to_execute;Description_given_to_user
  36.  
  37. P is the privilege level required for access.  This is just the first letter
  38. of one of the privilege levels, i.e. T)wit, D)isgrace, N)ormal, P)rivel,
  39. E)xtra, or S)ysop.  Users below the required level will neither see nor be
  40. able to execute the command.
  41.  
  42. C is a single character by which the program will be selected. It must be a
  43. single upper case letter.  Using letters instead of numbers insures that users
  44. at lower access levels will not notice "gaps" in available services.
  45.  
  46. Command_to_execute is the command that will be executed by selecting the
  47. command "C".  This can be a DOS internal or external command, complete with
  48. parameters and/or switches exactly as if it were typed at the command line.
  49. This command will not be visible to the user.
  50.  
  51. Description_given_to_user is self-explanatory.
  52.  
  53. EXECUTION
  54.  
  55. The user of Outer will see a menu like this:
  56.  
  57. You have 13 minutes left outside Fido
  58.  
  59. A) Play the Adventure Game
  60. M) Search for messages
  61. N) Check for any new files
  62.  
  63. Enter your selection (0 to Quit, ? for Help) 
  64.  
  65. The user's time limit in OUTER is determined by the sysop in the RUNBBS.BAT
  66. file.  The OUTER time limit switches (/l) has the same meaning as that used
  67. on the FIDO command line.
  68.  
  69. As in Fido, the /l value is doubled for PRIVEL and EXTRA levels, and halved
  70. for TWIT levels.  Users at the SYSOP level are allowed a per-session time of
  71. 4 times the /l value.
  72.  
  73. When OUTER starts, LASTUSER.BBS is checked against USER.BBS to check name and
  74. password integrity, and to determine the privilege level.  If the user has the
  75. SYSOP privilege level, the USER.BBS file remains unchanged through the course
  76. of OUTER.  Checks are made to ensure that OUTER will not overrun a scheduled
  77. event, and a time limit is established.  This time is added to the per-day
  78. time in USER.BBS.  If the user returns to Fido normally, any remaining time
  79. is then credited back to his/her record in USER.BBS.
  80.  
  81. OUTER has its own carrier detect "watchdog" function built in.  The use of the
  82. WATCHDOG program is not necessary when using OUTER.  This built-in watchdog
  83. uses the parameters given (/1 or /2 and the /V) to monitor the presence of
  84. carrier detect.  The use of the /t parameter disables this feature - allowing
  85. testing from the console.
  86.  
  87. If a user hangs up while in OUTER, or the time limit expires, the system will
  88. boot and the user will be "charged" the full amount of time allotted.
  89.  
  90. A user is prevented from "breaking out" of OUTER - control-C and control-Break
  91. are disabled.  However, in an external program, control-C and control-Break
  92. will work as expected, returning control back to OUTER.
  93.  
  94. DEFAULT SWITCH VALUES
  95.  
  96.      Session Time - 20 minutes    (20/l)
  97.      CD Mask      - 16            (16/v) - generally not the one needed!
  98.  
  99. ERRORLEVELS RETURNED
  100.  
  101.      0 = normal termination, user typed "0"
  102.      1 = parameter error or OUTER.CMD not found
  103.      2 = LASTUSER.BBS not found in USER.BBS
  104.      3 = scheduled event within 2 minutes
  105.  
  106. OUTER may be invoked from a batch file by setting it to run when Fido exits
  107. with the O) ERRORLEVEL.  This ERRORLEVEL is set with Fido's /a switch.
  108.  
  109. OUTER is a user supported program.  If you like it, and use it on your board,
  110. please send a donation of $10.00 to:
  111.  
  112.                            Jim Fullton
  113.                       2121 N. Lakeshore Dr.
  114.                      Chapel Hill, NC   27514
  115.  
  116. Other sysop utilities such as NEWFILES (shows files added to the board within
  117. user-specified number of days), SYSMENU (a remote sysop utility that does not
  118. use special graphics), and SPLTNEWS (the Fido News Splitter) are available
  119. from Fido node 151/104, along with their C source code.
  120.  
  121.                         Enjoy.
  122.  
  123.                         Jim Fullton
  124.